Release 10.1A: OpenEdge Development:
Progress 4GL Reference

DOWN statement

Positions the cursor on a new line in a down or multi-line frame.

When the block specifying the down frame iterates, Progress automatically advances one frame line. Use the DOWN statement if you want to move to a different display line at any time.

For more information on down frames, see the DOWN option of the Frame phrase.

Note: Does not apply to SpeedScript programming.

Syntax

DOWN [ STREAM stream ] [ expression ] { [ frame-phrase ] }

STREAM stream

Specifies the name of a stream. If you do not name a stream, Progress uses the unnamed stream. See the DEFINE STREAM statement reference entry and the "Alternate I/O Sources" chapter in OpenEdge Development: Programming Interfaces for more information on streams.

expression

The number of occurrences of data in the frame that you want to move down.

DOWN is the same as DOWN 1, except for the following:

Nothing happens until a data handling statement affects the screen.
Several DOWN statements in a row with no intervening displays are treated as a single DOWN 1.

DOWN 0 does nothing. If n is negative, the result is the same as UP ABS(n).

frame-phrase

Specifies the overall layout and processing properties of a frame. For more information on frame-phrase, see the Frame phrase reference entry.

Example

This procedure prints a customer report that is sorted by state, with one line after the last customer in each state:

r-down.p

DEFINE VARIABLE laststate AS CHARACTER. FOR EACH customer BY state: IF state <> laststate THEN DO: IF laststate <> "" THEN DOWN 1. laststate = state. END. DISPLAY cust-num name city state. END.

Notes

After displaying a down frame, Progress automatically advances to the next frame line on each iteration of the block where the frame belongs. This is true whether or not you use the DOWN statement. If you do not want Progress to advance automatically, name the frame outside of the block involved (the statement FORM WITH FRAME frame names a frame and scopes that frame to the higher block).
When Progress reaches the last frame line and encounters a DOWN statement, it clears the frame and starts at the top line of the frame, unless you used the SCROLL option on the frame. In that case, Progress scrolls the frame up one iteration only, to make room for the next iteration.

See also

DEFINE STREAM statement, Frame phrase, SCROLL statement, UP statement